home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / dev / gcc / ixemul_bin.lha / ixemul-41.0-bin / INSTALL < prev    next >
Text File  |  1995-06-13  |  6KB  |  158 lines
  1.  
  2.          IXEMUL  LIBRARY  INSTALLATION  NOTES
  3.  
  4.             (last updated 6/12/95)
  5.  
  6.  
  7. =====================
  8. DISTRIBUTION CONTENTS
  9. =====================
  10.  
  11. The net ixemul library distribution consists of two archives, one for the
  12. runtime files and one for the source, where XXYY is the major and minor
  13. version numbers:
  14.  
  15.     ixemulXXYY-bin.lha    ixemul.library, *crt*.o, includes, libc.a, etc
  16.     ixemulXXYY-src.lha    Complete source code for ixemul library
  17.  
  18. Note that version 41.0 would be 4100 and 41.10 would be 4110.
  19.  
  20. The ixemulXXYY-bin.lha archive contains various readme and copyright files
  21. that do not need to be installed anywhere, and another archive "runtime.lha"
  22. that can be extracted relative to the gnu: directory to put all the files in
  23. their standard location.
  24.  
  25. The ixemulXXYY-src.lha archive contains all the source, relative to a
  26. directory "ixemul-XX.YY".
  27.  
  28. ========================
  29. INSTALLING RUNTIME FILES
  30. ========================
  31.  
  32. For the moment, you must manually install the files.  Eventually there will
  33. be an installer script available that you can use with the standard AmigaDOS
  34. installer program to make installation more WorkBench friendly.
  35.  
  36. First make a work directory and unpack the archive.  If you have sufficient
  37. memory, the ram disk is a fine place for this:
  38.  
  39.     makedir ram:ixemul
  40.     copy ixemulXXYY-bin.lha ram:ixemul
  41.     cd ram:ixemul
  42.     lha -mraxe x ixemulXXYY-bin.lha
  43.  
  44. Next backup any files in gnu: that will get overwritten during the install,
  45. if you wish to preserve them.  These files typically are:
  46.  
  47.     gnu:bin/ixconfig
  48.     gnu:lib/bcrt0.o
  49.     gnu:lib/crt0.o
  50.     gnu:lib/rcrt0.o
  51.     gnu:lib/libc.a
  52.     gnu:lib/libb/libc.a
  53.     gnu:include        (lots of files, but probably not all)
  54.     gnu:man            (lots of files, but probably not all)
  55.     gnu:Sys/libs/ixemul*    (all the old versions of the library)
  56.  
  57. Extract the contents of runtime.lha to the gnu: tree, overwriting any
  58. existing copies of the files:
  59.  
  60.     lha -mraxe x runtime.lha gnu:
  61.  
  62. By default, the version of ixemul.library that will be used is for any m68k
  63. CPU and is not compiled to use an FPU.  If you wish to install a version
  64. better suited to your machine, say an 040 version using the built in fpu,
  65. then do something like the following:
  66.  
  67.     cd gnu:Sys/libs
  68.     rename ixemul.library ixemul000.library
  69.     copy ixemul040fpu.library ixemul.library clone
  70.  
  71. Then either reboot or run a program to flush the existing ixemul.library (if
  72. any) from memory.
  73.  
  74. =======================
  75. INSTALLING SOURCE FILES
  76. =======================
  77.  
  78. To extract the source code, simple cd to a directory where you would like
  79. the source code directory to be created, and extract the source archive
  80. there:
  81.  
  82.     cd gnu-src:
  83.     lha -mraxe x ixemulXX.YY-src.lha
  84.  
  85. Note that this will create the directory ixemul-XX.YY and populate it with
  86. all the source files.
  87.  
  88. To rebuild the library, all that is needed is to run the configure script
  89. and then run make.  Note that at the moment, you have to use separate build
  90. and source directories.  That is, you leave the source tree untouched and
  91. create a separate build tree in which all the compiled files will be placed.
  92. I.E.:
  93.  
  94.     cd gnu-build:
  95.     makedir ixemul-XX.YY    (must not be source directory at the moment)
  96.     cd ixemul-XX.YY
  97.     sh /gnu-src/ixemul-XX.YY/configure m68k-cbm-amigados
  98.  
  99. This will create a Makefile and several subdirectories with other Makefiles.
  100. Note the section in the Makefile that looks like:
  101.  
  102.     all:
  103.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  104.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  105.         $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  106.         $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  107.         $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  108.         $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  109.         $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  110.         $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  111.         $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  112.         $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  113.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  114.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  115.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  116.  
  117. By default, all of the versions of ixemul.library are build by make.  This
  118. can take a very long time (about a day on a 40MHz 040 WarpEngine for
  119. example, probably much longer on other machines).
  120.  
  121. If you only want to build one particular version of the library and runtime
  122. files to test, just comment out the lines you don't want.  I.E.  to build a
  123. 68040+68881 version, the above lines should be changed to:
  124.  
  125.     all:
  126.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  127.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  128.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  129.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  130.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  131.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  132.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  133.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  134.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  135.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  136.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  137.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  138.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  139.  
  140. Note that you have to build the 68000 version in any case, since the
  141. compiler runtime files (*crt*.o, libc.a, libbc.a) are generic 68000 code.
  142.  
  143. Then just run "make" in the build directory:
  144.  
  145.     cd gnu-build:ixemul-XX.YY
  146.     make
  147.  
  148. ==============
  149. REPORTING BUGS
  150. ==============
  151.  
  152. Please report problems or bugs to Fred Fish (fnf@amigalib.com), who is the
  153. current ixemul library coordinator.  Even better than a bug report is a bug
  154. fix, which typically would be a context diff file for one or more ixemul
  155. source files.
  156.  
  157. -Fred Fish (fnf@amigalib.com)
  158.